数据集

数据集

模型的all和select查询方法返回数据集对象 think\model\Collection，该对象继承自think\Collection，因此具有数据库的数据集类的所有方法，而且还提供了额外的模型操作方法。

基本用法和数组一样，例如可以遍历和直接获取某个元素。

// 模型查询返回数据集对象
$list = User::where('id', '>', 0)->select();
// 获取数据集的数量
echo count($list);
// 直接获取其中的某个元素
dump($list[0]);
// 遍历数据集对象
foreach ($list as $user) {
    dump($user);
}
// 删除某个元素
unset($list[0]);

需要注意的是，如果要判断数据集是否为空，不能直接使用empty判断，而必须使用数据集对象的isEmpty方法判断，例如：

$users = User::select();
if($users->isEmpty()){
    echo '数据集为空';
}

你可以使用模型的hidden/visible/append/withAttr方法进行数据集的输出处理，例如：

// 模型查询返回数据集对象
$list = User::where('id', '>', 0)->select();
// 对输出字段进行处理
$list->hidden(['password']) 
    ->append(['status_text'])
    ->withAttr('name', function($value, $data) {
        return strtolower($value);
    });
dump($list);

withAttr方法需要V5.1.22+版本可用。

如果需要对数据集的结果进行筛选，可以通过filter方法进行数据过滤，例如：

// 模型查询返回数据集对象
$list = User::where('id', '>', 0)->select()->filter(function ($data) {
    return 'think' == $data['name'] && $data['score'] > 80;
});
dump($list);

V5.1.22+版本开始，支持对数据集进行更方便的数据过滤。上面的用法可以改成如下：

// 模型查询返回数据集对象
$list = User::where('id', '>', 0)->select()
    ->where('name', 'think')
    ->where('score', '>', 80);
dump($list);

V5.1.23+版本开始，支持数据集的order排序操作。

// 模型查询返回数据集对象
$list = User::where('id', '>', 0)->select()
    ->where('name', 'think')
    ->where('score', '>', 80)
    ->order('create_time','desc');
dump($list);

V5.1.23+版本开始，支持数据集的diff/intersect操作。

// 模型查询返回数据集对象
$list1 = User::where('status', 1)->field('id,name')->select();
$list2 = User::where('name', 'like', 'think')->field('id,name')->select();
// 计算差集
dump($list1->diff($list2));
// 计算交集
dump($list1->intersect($list2));